home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / libelfutil / xlate_pro_disk_next_block.z / xlate_pro_disk_next_block
Text File  |  1998-10-30  |  6KB  |  132 lines
  1.  
  2.  
  3.  
  4. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____NNNNEEEEXXXXTTTT____BBBBLLLLOOOOCCCCKKKK((((3333EEEE))))                              XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____NNNNEEEEXXXXTTTT____BBBBLLLLOOOOCCCCKKKK((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______nnnn_eeee_xxxx_tttt______bbbb_llll_oooo_cccc_kkkk - get translation byte stream pointers
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_eeee_llll_ffff_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_xxxx_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  17.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_XXXX_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  18.      _iiii_nnnn_tttt _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______nnnn_eeee_xxxx_tttt______bbbb_llll_oooo_cccc_kkkk_((((_xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee______pppp_rrrr_oooo _pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  19.        _cccc_hhhh_aaaa_rrrr _****_****_dddd_aaaa_tttt_aaaa_,,,,
  20.        _EEEE_llll_ffff_6666_4444______XXXX_wwww_oooo_rrrr_dddd _****_dddd_aaaa_tttt_aaaa______ssss_iiii_zzzz_eeee
  21.      _))))_;;;;
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      This function gets pointers to the blocks making up the stream of data.
  25.      The xlate functions do not write the stream to disk.  Typically the
  26.      transformation-tool will use _l_i_b_e_l_f to write the bytes to disk.
  27.  
  28.      _x_l_a_t_e__p_r_o__d_i_s_k__n_e_x_t__b_l_o_c_k gets the contents and size of the next block
  29.      thru the pointer arguments.
  30.  
  31.      _p_r_o__t_a_b_l_e__p_t_r must be a valid open producer translate table handle and
  32.      _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r must have been called to create the byte stream and
  33.      count the number of blocks..
  34.  
  35.      It is essential that if the data stream gets written to a data file (an
  36.      Elf file) for later reading that the data stream be given a proper Elf
  37.      d_align of 4 for a 32-bit stream and 8 for a 64-bit stream.
  38.  
  39.      _d_a_t_a    The pointed at memory is set to a pointer to a set of bytes which
  40.              form part of the translation table byte stream.  The caller must
  41.              _f_r_e_e(3) the memory pointed-to.
  42.  
  43.      _d_a_t_a__s_i_z_e
  44.              The pointed at memory is set to the number of bytes in this block
  45.              of the byte stream.
  46.  
  47.      For an example of use, see _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r(3) and _l_i_b_e_l_f_u_t_i_l(5).
  48.  
  49. FFFFIIIILLLLEEEESSSS
  50.      /usr/include/libXlate.h
  51.      /usr/include/cmplrs/xlate.h
  52.      /usr/include/elf.h
  53.      /usr/include/dwarf.h
  54.      /usr/include/libdwarf.h
  55.      /usr/lib/libelfutil.a
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____NNNNEEEEXXXXTTTT____BBBBLLLLOOOOCCCCKKKK((((3333EEEE))))                              XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____NNNNEEEEXXXXTTTT____BBBBLLLLOOOOCCCCKKKK((((3333EEEE))))
  70.  
  71.  
  72.  
  73. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  74.      This function returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case
  75.      of error, a negative number is returned indicating the error.  In case of
  76.      error nothing is returned thru the pointer arguments.
  77.  
  78.      Error codes which may be returned:
  79.  
  80.      _X_L_A_T_E__T_B__S_T_A_T_U_S__I_N_V_A_L_I_D__T_A_B_L_E
  81.              means that that the _t_a_b_l_e is not a valid open producer handle.
  82.  
  83.      _X_L_A_T_E__T_B__S_T_A_T_U_S__B_L_O_C_K__R_E_Q__S_E_Q__E_R_R
  84.              means that _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r has not been called yet, and it
  85.              must be called before calling _x_l_a_t_e__p_r_o__d_i_s_k__n_e_x_t__b_l_o_c_k.
  86.  
  87.      _X_L_A_T_E__T_B__S_T_A_T_U_S__A_L_R_E_A_D_Y__D_O_N_E
  88.              means that _x_l_a_t_e__p_r_o__d_i_s_k__n_e_x_t__b_l_o_c_k was called more times than
  89.              it should have been since the last call to _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r.
  90.  
  91.      _X_L_A_T_E__T_B__S_T_A_T_U_S__A_L_L_O_C__F_A_I_L
  92.              means _m_a_l_l_o_c failed trying to allocate memory for the stream
  93.              bytes.
  94.  
  95. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.      libelfutil(5), xlate(4), xlate_pro_init(3), xlate_pro_finish(3),
  97.      xlate_pro_disk_next_block(3),
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.